home *** CD-ROM | disk | FTP | other *** search
/ The Apple Sales & Market…urce Library 1999 January / ARL Jan 99 CD 2.iso / Application Library / Music⁄Audio / soundsaVR 1.1 ƒ / soundsaVR 1.1 / soundsaVR 1.1.rsrc / TEXT_1000.txt < prev    next >
Text File  |  1998-10-29  |  14KB  |  239 lines
  1. Welcome to soundsaVR¬Æ, the wired sprite QTVR editing tool that embeds directional stereo sound into single
  2. or multinode panoramamovies.
  3.  
  4. READ ME  Version 1.1                                                                                                                                         October 29, 1998
  5.  
  6. System Requirements 
  7. ---------------------------------------------------------------------------------------------------------------- 
  8. soundsaVR requires a Macintosh PowerPC or compatible system with a base requirement of 5 MB of RAM and
  9. 5 MB of hard disk space for installation. The sounds and VR movies used will require additional hard disk space
  10. and memory. A recommended system configuration for adding sounds to VR movies is 16 MB RAM and 50 MB
  11. of hard disk space.  soundsaVR requires QuickTime 3.0 to be installed, and requires System 8 or higher. 
  12. Sound Manager 3.3 should also be installed as some compression codecs require it. 
  13.   
  14.  
  15. Usage Notes 
  16. ---------------------------------------------------------------------------------------------------------------- 
  17. Adding sounds using soundsaVR should be the last step in the QTVR authoring process. This is due to a special
  18. flattening process that permits QuickTime to loop sounds without storing it multiple times. As QuickTime
  19. editing software calls the default QuickTime flattening function, when a soundsaVR movie is re-flattened it
  20. will grow in size. Only soundsaVR is capable of flattening soundsaVR movies. 
  21.  
  22. Modifications using other editors such as Movie Player will work as long as the movie is not flattened.  To
  23. flatten the movie, open it with soundsaVR and save the movie again. 
  24.  
  25. soundsaVR preserves embedded media such as custom graphics or wired sprites. This is designed to provide
  26. further compatibility with custom authored panoramas. Note that object movies are not supported. 
  27.  
  28. Developers who are using authoring packages with scripting capabilities such as Director or mTropolis, should
  29. take note that each node is set to a length of one hour so that sounds can independently loop.  At the end of
  30. each hour the movie will transition to the next sequential node in the movie file. 
  31.   
  32.  
  33. Quick Start 
  34. ---------------------------------------------------------------------------------------------------------------- 
  35.  
  36.        Launch soundsaVR 
  37.        Open a QTVR movie with NO object nodes 
  38.  
  39.        Add sounds to all nodes (repeat as necessary) 
  40.            Select a node in the movie 
  41.               Import required sound files 
  42.                     Click the "Add Sound..." button 
  43.                     Choose a sound file from the dialog 
  44.                     Repeat until all required sounds have been imported
  45.               Set the correct direction for sounds that should pan 
  46.                     Select a sound from the "Sounds" list box 
  47.                     Pan the movie to the desired angle 
  48.                     Click the "Set Angle" button 
  49.                     Repeat until all directional sounds have been set correctly
  50.               Set the volumes for each sound 
  51.                     Select a sound from the "Sounds" list box 
  52.                     Drag the volume slider(s) to the desired level 
  53.                     Repeat until all sound volumes have been set as desired
  54.               Set the output options 
  55.                     Choose the "Save Options..." menu item from the "Edit" menu 
  56.                     Configure the checkbox options as desired.
  57.  
  58.        Set the output options 
  59.            Choose the "Save Options..." menu item from the "Edit" menu 
  60.            Configure the checkbox options as desired.
  61.  
  62.        Save the output movie 
  63.            Select "Save A Copy As...." menu item from the "File" menu 
  64.            Choose the file destination from the dialog
  65.  
  66.  ---------------------------------------------------------------------------------------------------------------- 
  67.   
  68.  
  69. The Menu Bar 
  70. ---------------------------------------------------------------------------------------------------------------- 
  71. There are three active menu bar items in soundsaVR: File, Edit and Options. 
  72. The File menu has four active items: "Open...", "Close",  "Save A Copy As...",  and "Quit" 
  73.  
  74. The "Open... " menu item will open a dialog to select a movie file.  Importing a file that has no panorama track
  75. or QTVR track will cancel the process and the user will be notified that the file was not a panorama.  When a
  76. valid QTVR movie has been selected, a soundsaVR editing window will open, displaying the selected movie file. 
  77.  
  78. The "Close" menu item will close the active editing window.  If the movie has been edited, and the changes
  79. haven't been saved, a dialog will open prompting the user to save before closing the movie, to close without
  80. saving, or to cancel. 
  81.  
  82. The "Save A Copy As..." menu item will open a standard put-file dialog allowing the user to save the current
  83. movie with edited sounds.  It is recommended that users do not try to overwrite already existing files. 
  84.  
  85. The "Quit" menu item will close all editing windows and Quit the application.  As with the Close menu item, the
  86. user will be prompted to save any changes. 
  87.  
  88. The Edit menu has one active item; the "Save Options..." menu item will open a dialog allowing the user to
  89. select from three checkboxes that determine output format.  Selecting the "Fast Start Movie" check box will
  90. specify that when the movie is saved out it will support progressive video downloading.  When this option is
  91. activated both the "Pre Load Audio" and "Fast Start Audio" check box will be enabled and selected. "Pre Load
  92. Audio" specifies that all audio tracks will be downloaded before any of the video.  If the "Fast Start Audio"
  93. option is not selected audio will not auto start play until the movie has been completely downloaded.  In some
  94. scenarios, if wired sprite pause/play controls are added to the movie, the end user can override the behavior
  95. you set by initiating audio fast start. See the section "Save Options In Detail" later in this document for more
  96. details. 
  97.  
  98. The Options menu has nine active items: the first two, "Degrees" and "Cross Hairs", toggle the info displays on
  99. and off.  The remaining six menu items set the color of the information displays.  The info displays check the
  100. dimensions of the panorama track, not the entire movie, and are therefore always placed in their correct
  101. positions even if a panorama track has been rotated or if additional media elements have been added to the
  102. movie. 
  103.   
  104.   
  105.  
  106. The soundsaVR Editing Window 
  107. ---------------------------------------------------------------------------------------------------------------- 
  108. Multiple soundsaVR editing windows can be opened simultaneously, depending on available memory.  Several
  109. copies of the same movie file can be opened simultaneously in order to save different versions of the movie,
  110. and to compare differences in settings. Clicking the windows "zoom box" will reset the window to its original
  111. size if it has been changed. 
  112.  
  113. The soundsaVR Editing Panel 
  114. Each window contains an editing panel on the left side, that has a "Node List", and "Sound List",  as well as
  115. buttons to add or delete sounds, and controls that set the volume(s), type (ambient or directional), and
  116. looping status of each imported sound. 
  117.  
  118. Add Sound... Button 
  119. Clicking on this button will open a dialog box where an appropriate sound file can be selected in the get-file list
  120. box.   Clicking on Open will import the selected sound into the current node and display it in the 'Sounds' list
  121. box.  Previously grayed out items in the soundsaVR editing panel will become active.  If a sound file (that is not
  122. in a QT movie) can be be played back in QT3.0, the Open button will change to Convert.  Clicking on the
  123. button will convert the file to a QT movie, save the converted movie to a specified file/directory, and then
  124. import it into the current node. 
  125.  
  126. Remove Sound Button 
  127. Clicking this button will remove the currently selected sound from the 'Sounds' list.  This button will be grayed
  128. out if the currently selected node has no sounds. 
  129.  
  130. Nodes List 
  131. There will be only one item in this list if a single node pano is open. If it is a multinode pano, the name of each
  132. node contained in the movie will  be displayed.  Clicking on a node list item will select it as the current editing
  133. node and the sounds list box will be updated accordingly to reflect any sounds that may have been embedded. 
  134.  
  135. Sounds List 
  136. This list box will be grayed out until at least one sound file is imported into the current editing node. To import
  137. a sound file, use the 'Add Sound...' button.  Clicking on a "Sounds" list item will select it as the current editing
  138. sound, and update the sound setting controls accordingly.  If the currently selected sound is set to be
  139. directional, then the movie screen will be updated to display the corresponding view.  More than one sound can
  140. be imported into each node, as long as there is enough available memory.  However, keep in mind that too
  141. many sounds in a node can confuse the listener. 
  142.  
  143. Auto Play Button 
  144. If this check box is selected, the audio for the current node will automatically start playing whenever the end
  145. user enters the node. If this option is not selected you will need to include an external mechanism to start the
  146. sound. 
  147.   
  148. Ambient Sound 
  149. If the "Directional Sound" check box for a particular sound is not checked, the  sound is considered to be
  150. ambient and its volume will not change based on the pan angle.  This is the default state of imported sounds. 
  151.   
  152.  
  153. Setting Ambient Sound Volume 
  154. Ambient sound volumes are set using a single control slider in the "Volume" section of the editing panel. 
  155. Drag the slider thumb to the desired sound level to set playback volume.  The volume is represented as a
  156. percentage of the maximum volume, and its current value is displayed in the upper right of the Volume
  157. section. 
  158.   
  159.  
  160. Directional Sound 
  161. An imported sound is considered to be directional (that is, the sound volume changes based on the pan angle)
  162. if the "Directional Sound" check box is checked.  The current pan angle is used when clicking on this check box. 
  163. When this box is  checked, the Volume section of the editing panel will display a second volume control slider
  164. and label the controls "Front" and "Rear" respectively. 
  165.   
  166.  
  167. Setting a Sounds Direction 
  168. The direction of a sound can be changed in two ways:  by clicking the "Directional Sound" check box or by
  169. clicking the "SET ANGLE" button after panning to the desired view. 
  170.   
  171.  
  172. Setting Directional sound volumes 
  173. When the current sound to be edited is a directional sound, the "Volume" section of the editing panel displays
  174. two control sliders and corresponding labels "Front" and "Rear". 
  175.  
  176. The slider labeled 'Front' indicates the volume that will be used when the pan angle matches the set direction
  177. of the sound source. The slider labeled 'Rear' indicates the volume that will be used when the pan angle is 180
  178. degrees away from direction of the sound source. 
  179.   
  180. Looping Style Pop Up Menu 
  181. Selecting an item will determine the loop state of the currently selected sound to indicate type of loop
  182. generated for playback.
  183.      None will play the sound only once. 
  184.      Continuous will play the sound repeatedly for the entire duration of the current node. 
  185.      Random Delay will play the sound repeatedly with random length silence between plays. 
  186.   
  187.  
  188. Known Issues 
  189. ---------------------------------------------------------------------------------------------------------------- 
  190.  
  191. 1) Object Movies are not Supported 
  192. Object VR movies, and multinodes which contain object nodes, are not supported. This is due to the differences
  193. between the format of object movies, and panoramic movies. There are no plans to support object nodes, as
  194. QuickTime currently does not have support for asynchronous track playback. As a result, this issue will not be
  195. addressed by soundsaVR. 
  196.   
  197.   
  198. 2) Each Node in a Multinode Movie MUST have equal durations 
  199. Movies containing nodes with different durations will NOT play properly. 
  200.  
  201. When authoring a multinode movie you  must use the same number of tiles for every node. If you are using
  202. source picts of different dimensions for any reason you can use the soundsaVR QTVR Tile Calculator (free
  203. HyperCard stack included with version 1.1) to help find suitable valid tile values for a set of source pict
  204. dimensions.  This stack also stores calculated values for later reference and allows set naming and searching. 
  205.  
  206. Different horizontal and vertical tile dimensions can be used as long as each node still uses the same number
  207. of tiles.  The following example is a compatible movie file because each node uses six tiles and will be of equal
  208. duration: 
  209. Node 1:      1 horizontal tiles            6 vertical tiles 
  210. Node 2:      3 horizontal tiles            2 vertical tiles 
  211. Node 3:      2 horizontal tiles            3 vertical tiles 
  212.  
  213. If you have problems with a particular movie file, then please send it (or one like it) to us for testing at
  214. "dev@smgVR.com".   You should send the original movie before it is edited with soundsaVR. 
  215.  
  216.  
  217.  
  218. Reporting problems 
  219. ---------------------------------------------------------------------------------------------------------------- 
  220.  
  221. soundsaVR is a new application that utilizes many components recently introduced in QuickTime 3.0. As a
  222. result of the wide variety of different types of sound compressors, VR creation programs and system
  223. configurations, it is expected that some conflicts and bugs are going to be found. 
  224.  
  225. Please consult the FAQ for information on current soundsaVR issues and bugs.   If you believe that you have
  226. found a different problem, please ensure that you can reproduce it, and check if it still occurs when starting
  227. up with only the required standard Apple extensions. Please also make sure that all source movies and sounds
  228. play correctly in MoviePlayer before they are brought into soundsaVR. 
  229.  
  230. If problems persist, please e-mail a detailed description of the problem, how it is triggered, and if possible, an
  231. example source movie, as well as what program the movie was authored with, to <dev@smgVR.com> 
  232.   
  233.  
  234. ---------------------------------------------------------------------------------------------------------------- 
  235. soundsaVR¬Æ - Copyright 1998, 1999 SQUAMISH Media Group, Inc. All rights reserved. 
  236. soundsaVR and associated logos are registered trademarks of SQUAMISH Media Group, Inc. 
  237.   
  238.   
  239.